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Verses added to a gcdden oldie 

At the very core of every Apple II ever built, from the first Integer Basic 
model to the IIgs,youll find something called the System Monitor This built- 
in software allows you to examine and control the Apple 11 at a veiy intimate 
level. Citizens of other computer kingdoms, who don't liave similar 
programs biiiK into theit computers, teill tell you the Apple Monitor has little 
significance —they'll say only Efssembfy language hl^ priests can use It In 
fact just the opposite is true. 

The significant thing about the Apple Monitor is that it has lured iena of 
thousands of mere mortals into learning how the Apple II works. There are no 
secrets in our kingdom (if s a tradition handed down fiom Woz) and there are 
no high priests. The Monitor is one of the major tools used" by laypeople to 
learn how to release the power of the Apple II. Likewise, it is this body of 
thousands of lajpeople who have learned how to release the Apple ll's power 
that maKe ttie Apple II different ftom tlie machines at tlie center of otlier 
kingdoms. 

Being one of the mere mortais myself ^conlpute^ high priests rarely accept 
English majors as one of their own), I've always had a great deal of respect for 
the Monitor, Way back at the beginning of Open-Zipple's Volume 1 you'll find 
Iwo articles, "A Song Called the System Monitor" (Februaiy 1985, pages 19- 
102) and "A Song Continued" (March 1985, pages 120-121), that were 
written to introduce the Monitor to those of you who had never used it. The 
articles describe the Monitor as it exists on the original Apple II, the ll-Flus, 
He lfethe lie, and the enhaneiecl lla 

Tips rpjojii wete going to summarize what was explained in detail in 
Arose iissuel anff w^re going to take a closer look at the Monitor as it exists 
on the newj^ple Ilgs. The Monitor changed hardly at all between the original 
Apple II and the enhanced He, even though the machines themselves 
progressed through several revisions. Tor example, the memory capacily of 
the machines grew from 48K to 64K to 128K, but the memory-examining 
capacity of the Monitor never grew beyond the original 48K 

Apple has foed all this in the Ilgs, however. The ligs Monitor has been 
enhanced wilii new powers and new commands. On the Ilgs you can 
examine and manipulate memory in the "language cards" and in the 
''auxiiiaiy bank" as easily as any other memory In addition, youTl find 
memory displays that can take advantage of 80-column soEens and show 
ASCII values, commands for converting numbers back and forth between 
h^ and decimal, mdsfis^eral commands that support new/eatures ef the 
Ilgs. 

Entering the Monitor, The usual way of entering the Monitor Is from 
Applesoft with a CALL -151 command. The entiy point of the machine 
language program that is the Monitor starts at $rp&, whifdi, js fequtetettttG 
-151 in decimal (or 65385, take your pick). 

Another way to get into the Monitor is to get the microprocessor to execute 
a BRK (break) command. The microprocessor will do this whenever it 
encounters a zero (the machine code for BRK) as it is executing a machine 
language program. Most users think of this as "aashing into the Monitor." 
When the program you are using beeps, puts an asterisk on the screen, and 
displays a new row of letters and numtiers every time you press return, this is 
whathas happened to you. Unless you have a Ilgs, you'll see a line that looks 
^SelfifilllMthfe Sdrheyiere 
0B02- H^ea x^is v=25 p=2^ 3=e4 

On a Ilgs, the line looks more like this: 
m/m^: m m brk ee 

f^mm x=00i5 Y=0ez5 s^eiEi a^mn p^ae b=0b K^m n=idc q=B0 L=i iii=i x=i e=i 



Machine language programmers use BRK for debugging purposes. A BRK 
skips a program at a spot selected by the programmer and allows 
examination of the micFopiDcessor's memory registers and the computers 
memory. When a commercial program executes a BRK and crashes into the 
Monitor, ifs a bug. Finished programs aren't supposed to do that 

A third way to get into the Monitor but only on the Ilgs, is with a desk 
accessory called Dwersl-fiack Interrupt any program with open-apple/ 
control/escape to get to the Ilgs desk accessory menu, choose Diversi-tlack 
from the menu, and you are in the Monitor. The Ilgs Monitor's new Q(uit) 
command will take you back to the desk accessory menu; a quit from there 
will take you back to the program in progress. Fornioi^iaboul Diiiersi-Wacfc 
see my inhnduction to this nionth's letters. 

Once you get into the Mbnitdr,youll find that its commands fall into four 
groups. There are commands for examining memory, commands for 
changing memory, commands for program conhol, and miscellaneous 
commands. 

Examining Memory. The values found in a computer's memory cells can 
represent just about anything, but most often they represent either numberSy 
ASCI I characters,or macliine language pragnams. The Ilgs Monitor gves you 
lods to examine RAM and ROM ntemoiyfrom eadh of these three perspectives. 
(The Monitor on older Apples dtmn t Include an ASCII display but Opart' 
^ple already solved that problem back on page 112. If you don't Know RWi 
from ROM from registers, go back to the beginning of our second volume and 
t!y '"The Magic of Peek and Poke," February 1986, pages 2.2-2.5.) 

To look at memory from the perspective of numbers, you enter the hex 
address that you want to see the contents of and press return. Successive 
returns display successive bytes of memoi^; To display a range of memory all 
at once, enter the beginning and ending addresses separated by a period. 

The Ilgs offers several enhancements to tiiis syiSbem. First of all, the Ilgs 
displays the .^SCII representation of each byte along wdth the numerical 
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Value. Ifyoueoein ^O^xd^niniapde, UjeMonitor will notice it and will display 
16 bytiison eadiHrKtnsteadOftfieusual eight Rnally, pressing controt-Xwfll 
terminate the display of a range of memoiy values. On older Apples, the only 
us^ to terminate a range display is to ptess control-reset Here is wliat the 80- 
csluipipfWEKjrdisp^ the 11^ 
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The ASCII characters on the right side of the display represent the same 
sixteen characters that appear numerically in the midsection of the display. 
This example shows a range of memoi>' that I purposefully filled with values 
from to 255 so you could see the relationship between values and ASCII 
characters. Contnid-characters art dispJ^iyed as periods. Ho distincdoii is 

The numbers on the left edge lepiesent file tnonory atldr^ of tiie firstof 
the sixteen bytes in each line. The 6502 BiiiictDprocessor used on earlier 
^ples could accommodate only 65,536 discreet memoiy cells. Thus 
Monitor addresses on these Apples ran kom $0000 to $nTF. The micropn)- 
tfissor in the llgs, on the other hand, can accommodate 16,777,215 discreet 
memory cells. These arc arranged as 256 "banks" of 65336 cells each. The 
number in front of the slash indicates which bank you are kx^diig at The 
number after thesMi gwes theadctress within tbatbank. 

terft»% at a dffibrent bank,you can enter anumtier suc^ 
ITris would display ' page " $20 !n bank $02. The addresses you ^ must 
both Ise within the same bank. 

L(ist). The third perspective for looking at memoiy is with the Uist) 
command. Enter an address and "L" and you will see a "disassembly" of the 
section of memoiy that followii that address. Mot all ranges of memoiy 
actually hold machine language pn^rams. Some hoid data, some hold 
programs in other languages, some hold nothing at all. The Ing Utalion of 
the list command (a limitation It shares with oQier disassemblers) is that it 
can'ttdlreal machine language code from oth^ kinds of data. It "disassem- 
bles" everything whether the resul ts are mcanlngM or not 

The llgs list command is able to disassemble all the 65816 operation 
codes and addressing modes. For a complete description of these codes 
and modes see "A 65802/65816 pre-boot" and "Introduction to the 65802/ 
65816" in our August 1986 issue, pages 2.49-56. 

One big problem that occurs when apiogram tries to disassemble 65816 
machine code s ftal fhe "InmecSate i^g" of fitt^ ooUttion^'ttsed 
in5tnictbiis>LQA,IibX,andIi)Y,canbeetthertwo orthiee bytes long and ttie 
disassenflflercanttdl \»*ilch. These commands bad ttie miaoprocessor's 
A, X, orY register. With immediate addressing, the data that is to be put into 
the register is embedded within the program immediateiy after the 
instruction byte, if the registers are set up for 8-bit data, these Instructions 
are is*n bytes long (one insbnction or operation-code byte and one data 
tiyte). If the legisteis are set up for 16rbit data, on the other hand, these 
instructions ate three l^ks long (bvo data liytes). But a disassembler can't 
tell vAiIdi is Which. Fra-exatnf^e, tbto the Dgs Monitor and by tils 

•FF/e28X 

ism l=x l=LCBflNK [8/1) 

FT/izes: R3 ra M m 

FT/eze?: es 9S m es. 

'HioseBI^tnstnictlonsbitieseGGndandiMltoesWf^^ 
Perhaps this section ofcode was written to be executed with 16-bit refers. 
To tell file disassembler thatyou'd like to see the code listed that way, enter 
0=m (16-bit A register) and 0=x (same for X and Y registers). Mote that the 
format of these commands is backwards from what Applesoft programmers 



woilid ecpect (p=m, not iri=;Qj!, IJwt "m" and V must be entered in lower 
case, andlhat^ecra^lst^s^^onif and V Is alwa^ displayed ^Oie 
top of a listing. Bar exampfe 

9^ e=x. isLCBmK [e/1'3 
FT /Bzes: m m m m . mm 

FT/eTMl: RZ m W>3»» 

When you examine memoiy with the Monitor and you look at bank zero, 
you will ahcays see the "language card" F5AM In the address space fium 
$D000 to $F?FF. If what you really want to see is the ROM that is normally 
found in this address space, look tor it In bank $fT. Thafs what we've done 
here. (There's more ROM in bank $FE.) Mote in the above examples that once 
you've set the bank to $FF (or whatever), it will stajrtlKiE (with one exception 
to be noted later) until you change it again. 

UnUke ttic ROM code, the hardware soflswitches and peripheral card 
firmware that aj^ear in t}ie addiess range torn $C(KI0 to ICITF on eailier 
Apples appear ^ere stfil on Ok llgs (but in batiks M), $09, $filO and $B1 
only). Hius, two banks of $D00O-$DFFF memoiy are needed to squeeze 64K 
cf RAM into these banks. To control which bank you are looking at, enter 1=L 
to see the main bank (usually called bank 2 in the Apple HteratungJ and 0=L 
to see the secondary bank (usually called bank 1 ). 

In addition to allowing you to examine sequen tial memoiy bytes as values, 
ASCII characters, and assembly lan^iage mnemonics, the llgs Monitor gives 
you the power to examine memoiy by searching for a specie £(jl)e paptn 
andt^comparit^ two segments of memoiy for difeimm 

l^ailern iiaBiiKl, Ttie Mil^fi C Monfior to ba«ie a^rell aoBiinaiii 
iiiBSthetcneiatheentianced lleOnthatmachineyou can search memoiyfixr 
anyone-byte or iM}-byte value The command's syntax is "¥YXX<adr.adiS'' 
where YYXX is two sequential Ijytes app^tring as XX YY. Yes, tti^re 
backwards. 

The llgs search command Is veiy different from the one in the enhanced 
lie. First of all, rather than being known as S(earch), as on theenlianced lie, it 
goes by F(attem search). Second, the values (or pattern) you are seardiing 
for can beiqi to 236i9tes k>ng. Third, the pattemyouaieloakingformustix; 
suribunded by badt^la^hes. fburth, the pattern can include hexadedmal 
values, ASCII values, or "flipped" ASCII (flipped means bad!Wards-"BOB" 
instead of "BOB," for example). TYy this: 

*\Z8 ED FD\<FF/FBeB.FFrrp SaarBh Homtoi- cncfe for JSR SFDED 

FF/F34C:. 
FF/F04fl: 
FF/F064: 
FF/FDBC: 
FF/FF?: 
FF/FF34: 
FF/FF37: 

»\-Rpple-\<rFrtaM.FFFFj! ?8sn* taj* SFT for -ftpjilB- 

FF/BBa2: 
FF/a9H7: 
FF/C7G7: 
FF/F91<(: 
FF/FBe9; 

When you search for ASCII characters as we did above, the search finds 
only high-value ASCII characters. However, the llgs Monitor has an "ASCII 
filter mask' that will modily the characters you specify to tovmlue ASCII or 
to other weird stuff. The filter mask goes by the name 'T.' It can be set to 
anythingfiomSOOto $FFwlththe =F command, SFFis its iiatuial setting. $7F 
will getyoulowvataeASGll.'nie btber^settiiagsaffiorquesiionableiifalue. 
"nythis: 

*7F=F 

it\'ftfifftrWF/»,W.fFFFp rttrch bfcik iFF for 'fpals' 

FF/Zfll9: 
FF/912B: 

»\'PDS0'\Oee8,BrFFp asarl* es/BMB to BFFF far 'OBPP* 

Notice a couple of thing? here. The search for "Apple" with Hie ntKFsetto 
$7F turned up two more oocuircnces that the first search didnt catch. 

Likewise, none of the first search's hits turned up in the second search. This 
means the "ASCII filter mask " doesn't create "wildcard" bits. Instead, it 
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^nply clears bits in the character pattern spediied. Only exact matches with 
Hl^ iKwpaQan MU be foiuidSecoi^ notice lliat in tiK search for FOQO 
tadBiaidsfdie badhtvanis^P^ 

lather Ibana double quaten^J wedidbitqied^abBnk address, but in all 
the other searches we did This is because Ok ilgs search command always 
drfauits to bank zero unless you specify another bank. This Is inconsistent 
with the other Monitor rammands, v^-hich default to the last hank specified, 
and is the exception to the iast-bank-spedfied default that was mentioned 
earlier. This is piutiabiy a tiug, but maybe there's a good reason for it I haven't 
discovered yet 

V(eii4r). The command for comparins, or "veri^g" two s^pients of 
meni(Hy hasn't changed from filler J^te Us, except that bai^ ad^essil 
can now be spedfled. Wa^ means an address of either the km "XXXX' or 
"XX/XXXX," Bien the firnnat of this command is "adr<adr.adrV"..The tiKo 
segments of memory you are comparing can be in diioent banlis, but 
neither segment can cross a banK. 

For example, load an image of Applesoft as found on the lie in to a Ilgs at 
$2000. (More on how to adua% do this later.) To compare this inu^e to 
in the Ugs, do this: 

nlzzes-.M [9E1 

Fr/FirE:3e (S9) 

Ff/r233;D9 (W) 

fUfT-A-Jv [77] 

FF/F3CC:3fi (791 
rF/F3C0;F'J («! 

As you can see from the display, the two images are almost exactly the 
same. For a complete description of the differences between 11c Applesoft 
and earlier versions, see "Up where Applesoft lives' in our June 1985 issue, 
pages 140-44. The primary difference is that lie Applesoft (and now 
Applesoft on the Ilgs) includes support for double4ow-reso!ution graphics 
(80 pixels across the screen by 48 high). 

(Tlie differences between lie J^pleseft and 11^ J^jplesoft ateais Mfxm 
$^K)6 Is a spare byte Biat Ms had mA<m vahies in various %rs!cns 
Applesoft— the zero in this byte on the Ilgs matches what the original 
Applesoft had The next three changes fix a bug in the double-low mode that 
allowed the Y coordinate to be as large as BO on PLOT and SCRTi comma nds, 
when 4fi should have been the maximum. The last three changes were 
necessary because the Softswitch for reading whether double-resolution 
graphics are turned on isn't in the same place on the lie and ilgs. 
Mysteriously, a one-byte change neceasai^ to ffiia biq In the doubleHow 
SCRTi function, which was mentioned in our June 1985 article, wasn't done. ) 

Hodi^'iim Nemoiy. There are several ua^ you can use the Monitor in all 
models of Apple ii to modi^ RAM maiMsy lb dim^ one l^ ^mla- flie 
a(khessofthebyteyDUMantiioctwg&aaili»,andte^!^^ 
the bytes that MoW the flist, enter moie vaili^ 
space between each. Afta* you press return you can ccm^mfe lAdtieie you ie^ 
off by simply entering a ccSon and more values. 

!n addition to entering hexadecimal numbers, the lie, enhanced He, and 
Ilgs have what's called an "ASCII input mode." On the lie and enhanced lie 
you can store the ASCI I code for a letter in memory by typing the letter with a 
singlequote in front ofit, Ifyouwanttoenter several letters in a rowyou must 
ptecedeeatiiwithasingiequote,liltefl]is: 

•fflM:'D 'r 'a '9 '0 'n " 'b Ilc/wtfancsd Ub IffiCII Input apdi 

awe- C4 F2 a p EF ec n? n 

ASCII input mode on the Ilgs is much different Instead of preceding each 
letter with a single quote, you surround tire letters with double quotes. The 
characters you enter are marched through the ASCII filter mask (mentioned 
earlier in the discussion of the search command) before being stored in 
memory— thus you can use the filter to obtain low-value ASCII. Only high- 
value ASCII is available on the lie and enhanced lie, tlere ate some 
eramfdes: 

'07/106: "Dragtm'B* 
•180.10F 

•?/eiMtpi Fa (1 p EF EE fl? ra FF fr FT rr FF FF rF 

•IMs'Drijon's' 
"lia.UF 

e?/m8;F3 fffl EE or FF FT FF FF FF FT FT rr FF FF FF FF-6-nd 



?T F 

"Dragon '5 
•1».12F 

e7/ejze;44 72 6I 67 Sf St. 2? 73 FF FF FF FF FF FF ---Dragon s... 

As you can seein the second example, a single quote is supposed to give 
you backward, or flipped, ASCII, flowever, it seems to work only with the last 
four characters you enter That's a bug. In the third example, 1 changed the 
filter mask to get low-\'alue ASCII. Notice that you don't neally need a closing 
quotation mark if you're at the end of a line. (In comparing the ilgs wfth ttie 
lie and lie ljust noticed another important MonitorifiSbaioe— 'Onfliel^ 
the keyboard's delete ke^ works, at last at lastj 

H(oi«). Hie move command vMcta is auaDable dn all vmfons crf flie 
Monitor, piovides anolbia' wsqt Ip modi^ DKmory The command syntax is 
"desKadradrH" *dest" is the desttnailon address and tiie 'adr.adi^' 
range defines the segment of memory you want to move. On tiie Ilgs this 
command can move memory from bank to bank, but just as with the verify 
command, it can't deal with ranges that cross a tank boundary. It's also 
Important to make sure the destination area isn't inside the source area, or 
you may get results otirer ttian those you expected. 

Earlier I mentioned that I'd showjKWhowtosetaQ imjaige of licApplesgfi 
Into the Ilgs, so that the two can be oxtmiied, ^aa cant |icst BSAVE 
nCJTJMAQ&MDO0OJJ$2B0O because wtde^ BSAVE is going on RiQQS 
itffl beacflve.The snapshot you ii get wiU bettfUieFiEiOOS kemal ratberthah 
of Applesoft. This can be bewildering. The sdutloil Is to dtin late the 
snapshot with DOS 5.3, or do this: 

■zewsDeae.FTFFn •»« flppiaairt's inga to nem ;ds an « iic] 

IBSAVE nC.FT>.imGC.fl»H8,LI2eM 

Z(ap). The Ilgs has a new command for filling a range of memoiywitha 
specific value. The syntax is "val adradrZ", where val is a hexnumhex For 
example, 7<07/0000,rrFFi will put a seven in eveiy byte tabanksoKn^Wdi 
is not necessai% a good thing to do. You can also zap memoiy on older 
Monitors, but ft raiutesa txidi, Tty; 

»2000:0 

»2001<2000.20FtI1 

Because the destination address Is inside the source address, the effect of 
this commatulvaibe Id nioK flK valueattjyte $2(KX) liMo eveiy t^te 

page. 

The nini-Assanbler. The final way to modify memor>' with the Monitor is 
to use tiie Mini-Assembler. The heritage of tire Mini-Assembler goes back to 
the original Apple II, where it could be found as part of Integer Basic You can 
run the integer Basic Mini-Assembio' by wHaaSDg the ftoniloir wivie hite^er 
Ba^ Is acdle and typing WXfT. Becatne It uses "teidocunteflted entiy 
points," however, the Integer Basic Mini-Assembler doesn't worit right on fte 
lie or Ilgs. On the enhanced Apple I le, the 3.5 ROM lie, and the llgS/you can 
start up newer versions of the Mini-Assembler directlv from the Monltot^ Wflh 
or without Integer Basic by entering an exclamation point 

The Mini-Assembler can be used to write short, uncomplicated assembly 
language programs. If s much easier to write longer programs on hiU-blown 
assemblers because they allow you to give names or "labels " to program 
segments and addresses, because ttiey make It easy to insert new lines in 
what you've already written, and because they provide many other amenities 
that the Mini-Assembler doesn't All the Mini-Assembler can do is allowyou to 
type in one assembly language mnemonic and operand at a time; it converts 
these into the equivalent machine language values and stores than In 
memory, nonetheless, it's a useful and handy tool to have around. 

it was possible to execute Monitor commands from within the original 
Mini-Assembler by starting a line with a dollar sign, This isn't possible witii 
theHhiktesembleis tti^siatiq) wUi an ecdamation point However, ifsnot 
neoessioy either ttecaiaeyon oui SMdtcb bebNeen the Mini-Assembler and 
theHonilorsaeasiljronQii^ pointgetsyouhi, 
rehitn on a blanklme gets^^xiO-badSlioiw&iel^BlM^Aasenibler does 
allow you to directly enter het or ASCII WtseS hlto memory. 

Once you are In tiie Mini-Assemhfct'ftefiist tiling you must do is provide 
the address where you want your machine code to be placed. Fol low that with 
a colon and an assembly language instruction. The allowable instructions, 
addressing modes, and addressing mode formats for the Minl-Assemblei are 
shown In our August 1986 issue, page 2.52. The Ilgs Mini-Assembler can 
handlealloftfae 65816 instructions and addiessingmDdes;the35 He model 
can hindte an ^0)2 instmctfons; other modeb handle ontjr the 6302 
instructions and modes. 
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Begin each l!ne you enter M!er ttie first with a blank space if you want that 
line's machine code to follow the pievious line's. On the Ilgs, a colon instead 
of a blank space tells the Mini-Assembler that hex data follows. A double 
quote mark instead of a blank indicates ASCII characters (which will be. 
forced through the ASCII filter mentioned earlier). A number indicates you 
are giving a new addtess for storing machine code. Thus; 



•! 

\2m:US( M 

ee/zeez: bd tL iz 

! BCQ 2M0 

«)/2ee5: re 

! JSR FDED 

Wm?: 29 EO fD JSR FOCD 

! INX 



load a zero Into X rsgisisr 



load A ulth iihat'B at fZesn+X 



LDX m 

LDfl 28tl£,X 

BgQ 2e«i branch on squal^'dld A gat s zerci? 

jiap to tha PRINT subnuUna at ifdCD 
INX IncrEmert X (X=)!+l) 

fiNE 2892 {-SB} if .»;< >e, braaeh to gat nsxt charactsr 



! STS 



fits 



raturn Ca cailBr 



CBnd Dpan-flpple euery aonth fo^ beatth and uatltti- 
!:0 

How did I know While I was entering tbe second line that the ASCII string 
ttK KMitlpe pdnCs wpuAd mswM $20CE? I didn't This Is the kind Qf tbup a 
true aessenuiiler handles sisii^ ln1^ case, ll!^ necessary to guera i^ liie 
correct address (in order to save space for the instruction), tlien go back and 
correct it after you have finished the program and know tlie correct address. 
Ifs also necessaiy to guess at and correct the destination of the branch in the 
third line of the pTr)grani. Incidentally, the Mini-Assembler displ^you see on 
your screen is much cleaner than what's posslbletoshowlteie— the output 
for each line overwrites the input Try it and see. 

Program control. Once you've entered the above pio^am with the Mini- 
.Asser(iblei;piessretuni onablank line to setback infflde the Honitor and try 

>2eWg 

Head Opeo-flpple every itiorth For health and ueaith. 

The Q(o) command tells the Monitor to execute the subroutine at the 
address you give. $2000 is the temporary home of the Chteese forteme 
subroutine we just entered with the Hini-Assembler. 

An important but often overlooked, aspect of the (Q)o command Is that it 
loads the miooprooessor's legistm witli specific values, udildl you can 
conhoi, just before jumping to the subrmiflne at tfie addross ymi 5pe#. 
(Incidentally, it does JSR, not JMF, so if the routine you call ends idlh an RT5 
you l! return cleanly to the Monitor, as in the example here.) 

TVythte 

•(press controI-E and returnj 

— display on II, Il-Plus, lie. He, enhanced lie 
(NW S^IS V-25 

^"di^lay en 3iS lie. 
MB fcffl X=15 ¥is2S P»3Sl SiF» 



— display on llgs 

R=aa8B x=a0i5 Y=ee25 s=»iFa amm p=3« b=i 



(1=01: 0=88 L=l m=l 11=1 e=l 



CDntiikitQsii^ lie values that wil] he. placed in the mioopiocessor's 
registers when oontiol is passed to the address you specify with the Q(o) 
command On the 35 He and the llgs some of the displayed values aren't 

actually regista^, bat are "flags" that indicate which memoiy banks will be 
active when Q(o) Is executed, as well as other stulf. You see this same display 
after the microprocessor hits a BRK instruction, as mentioned many 
paragraphs ago. liot only is the display the same, so are the values. In other 
words, a BRK puts you into the Monitor and displays the values in the 
registers when the BRK occuned. The flags indicate the status of the machine 
at that time. 0(ctf MiE^^ the pttigratn mMi ftose same values In the 
le^steis and that same machine status. 

You can, however, change the values ftom the Monitor If you like, so that 
Q(o) will use different values or flags. On all machines except the llgs you do 
this by pressing control-E and return to get the register display. Then entera 



colon at the be^ntng of the nertlme followed by Ihe valueyou want In theA 
register, the value you want in the X register, and so on. If you'd like to 
experiment with this, be. aware that changing the P or 3 register to a random 
number some times locks the machine up so tight you need a can opener to 
get it back open, (To change the M register on the 3.5 lie use "44.^1". ) 

On the llgs, on the other hand, you change the values that will be placed in 
the registers by entering ihe new value you want, an equal sign, and a letter 
design^g tte ii^si^you want to cbar^ We used this fonnat eaiiier in 

can also icstoie the Tegbters and &i0 a '^^ittaf configuiatidin 
pressing control-R 

The program we entered earlier with the Mini-Assembler begins by loading 
the X registerwith azero. You can see whatwould happen with other values bry 
changing the Jt legiste' value wtth the Itonitor aid Q(o^ to foe 
example: 

— <11 but llgs —Itgs 

•[Eontrol'E return] _ »(control-E return Is optional on Ilga) 

'(registers are dispUysd] (registers are displayed) 

Dpen-Appts. every minth for health and ueaith. 

The A register is Ihe microprocessor's accumulator, where all math 
operations arc done. X and Y are the index registers. S is the stack register, 
which points a crooked finger at tlie current stack position. F is tlie 
microprocessor's status register. The meaning of its bits change slightly, 
depending on whether the microprocessor is in 6502 ("emulation") mode or 
65816 ("native") mode. Only the llgs has these two mode& The "e" flag teUs 
you which mode the machine is ini 1=6502 nuHte, 0=65816 modei Here's 
what the bits in the F register mean: 

leaning of the P(rocBSBQr status] register 

NVlBDifC s=t<in itge wdB] and all other (ifpla 11a, 
N U N X D I Z C e=0 on llge (ESBIE aoite) only 

N is sign; 1-negative 
^ is ovErflow; I=true 
I is unused 

M is fl-rEgister uidth; 1-Q bits, 0-16 bltS 
B is brsak flag; 1-BRK, e-harduara interrupt 
X is X-reglster uidth; 1=Q bits, 0=16 biCS 
is binary coded deslnal fiag; l=trua 
I IS Interrupt Flag; l=inl;Brnjpts disabled 
Z is lero. flag; l=truct 
r: la rairpa; ■fiag:? Isirae^ 

Thebteiofite^R^^sta'intficate the state of the machine's memory ban^ 
udien a BRK oGgtned. cir how ypu tiant the tanks an-anged for the next G{o) 
command. Botbtlie35 ncandthetlpi^pl^anMiepstg'.HeR'swhatthe 

bits mean. 

Meaning sf tfe rttawry statuBj Ttgisier 



it P2 RD UR LC Bl B2 m 
flZ PK RD UR LX BX flR CX 



3.5 lie only 
llgs only 



aa la unised 

(Z im altarmta language card/zero-p^/stack; I-actlve 
Pi IB SmSBB/PRBCZ atatua; Isfaotti acUue 
PX iB RflSCZ status enlyt Imnim 
REl la eumaa reaa atatus; Inactive 
W IS luxnen uri tS: status; laactiue 

LC Is larguage- card read statue; l^card active 
LH la lan^iage' card statue; i^ROR active 

Bl la: larqage card banlt I. read status;; l<wtlua 
ex 18 auerrldden by L (eee text); Ie:bank 2, 9«tiarl«l 
■BZ- is language twi bank 2 rrati status; l=iBtlve 
RR is altamate ROM bank |see tsKt); I-acttue 
M Is meed 

CX is aiternata ICle0-$CFFF ROH;, Isactius 

The meaning of the bits In the 3.5 He's M register is similar to, but not 
exactly the same as, the M register on the llgs. In particular, the LC/LX bits, 
which indicate whether ROM or RAM is active in the $DOOO-$mT memoiy 
area, have exactly opfjdsltginf^Kns^. On the Ilea onein thatbtt means IW1 
is active, on the llgs a one means ROM is active. The He uses two Ints to 
IncBcate which language card tiank is being used; if neither (If ROMIsxitive), 
both bits are cleared to zero. The llgs uses just one bit for this (l=bank 2, 
0=bank 1), but changing that bit in the M re^ster is a useless exercise —ifs 



t^mAf^ 3^9 



dlmys overridden by tbeLflag,#kli\ietool(ed4eatQ£a:'in our discuss! 
of tbei^jst) command, 

Bbtti {he 3.5 ffc ^ %$h!Hie an attertiate 16KR0M bmik tet^an be 
turned on with softswitches. Only theligs hasa bit in the M register to activate 
that ROM, however. On the IFgs a program can obtain all of the information In 
the Monitor's M tegistet in exactly the same format, by reading byte $C068, 
riot only that, but writing to the same byte (which is called the "state " 
register), a ligs program can change the machine's memory coniiguration. 
This provides Apple's programmers with a speedy way to save and lestoie the 
meanoiy configuration of the Ilgs during an hitemipt, 

"Hie EonbokBie^nie regtet^l command in He Ilgis WseiW sets the H 
rEgisterfdlOe.AQ(b;^«ifli1t^^ 

banlt of RAM and put the Applesoft/Monitor ROM in the $DOOO^IWF area. 

The Q register (for "quagmire," according to the Ilgs doaimentation) that 
appears in the Ilgs memoiy display combines information from t\vQ other 
Ilgs hardware registers. These are the "shadow" register at $C035 and the 
"configuration" register at $C036. 

On Ihe Ilgs, what you see on your screen is always a reflection of 
infonnatlon stored in RAM menioiy banks $E0 and $E1 (On other Apples the 
£Ki|n(e >ddeo area is in bpi^iOQ and $(0.) $inc£ Apple II pixjgipm^ wdtt^ 
bd^ the Ilgs ap^}eaiied don't]mowbank^$^^ 
and Loan, the Ilgs hardware automatically "shadows" anything that is written 
into certain parts ofbanhs $00 and $01 into the same parts of banks $E0 and 
$E1 Ifs as if you were able to deposit a dollar into First National and have 
your sugar daddy make a matching deposit into E-Rrst national for you. 

There may be situations, however, when you wouldn't want a matching 
deposit made. For example, if your piDgpm is using the high-resolution 
gra^iMcs page 1 memoiy ai^ ($200&$3nT) for data Instead of pictures, 
U^re be no leason to have the data shadowi^d^ BP/200C>-^PF as 
well. With shadoMng on, anyfiring previously stored m ttie SSdOO-SFTfai^i 
of tank $E0 would be desboyed by writes to 00/2000-3rFF, Shadomng also 
slows down the Ilgs slightly. Under ProDOS 16, shadowing is normally turned 
off and video display manipulations are made directly to tanks $E0 and $E1 
Under FroDOS 8, DOS 33, and Pascal, shadowing is normally turned on. 

Most of the bits in Q come from the shadow register. Only one, the one that 
indicates machine speed, comes from the configuration le^ster. Hoe's the 
m^n0 of the fiilB & the qtiagattt 

Maanlng oF the P[uagniire! i^eglBlar 
5P Lh M (W BH HZ HI Tl 

SP ts procBsaor 'spBlEil l^t^. ^tnorKl - 

tn is Ltmw mmn^ l=m t/Q-'^paca at tom In bsuJus see W 'Id 
.M. 19 uwaod, UBt tas: zeffB 

nx Is auKm hl>ree ovBrrUa; l>m hl-rea auMian ahadoylng 
SH. u aupip lit-i^ (Ei/zeee-SFPPjt Xmt shadoning 
HZ Is naln/aux hl-paa psgs .Z^ tmo' ^atlBHIng 
Hi Is laaln/ouK hl-ras psge I; lona ehvdoulrig' 
Tl Ls fflain/aUJt text psge 1; !=□□ ^hsdaulng 

Control-Rsets the Q re^sterto either $00 or $80. The speed is left as it was 
before the control-R. 

Notice tbatit is possible, by manipulating the IM bit on the Ilgs, to disable 
the toguage cards and the $COOO-CFFF hardware in banks $00 and $01 If 
you did this, the RAM in banks $00 and $01 would become condnuous-'lbe 
primaty language card bank (bank 2) would appear in tlK $CODO atea and 
the secondaiy lank would be at $D000. Ttie $C000 hardware would appear 
only in banks $E0 and $E1 However, this isn't a practical alternative because 
Ilgs interrupts use some ma±ine language code that lives in the $C000- 
CFTF ROM in bank zero. Interrupts cease to work when you invoke the linear 
memoiy option. 

The other three registers shown in the Ilgs register display arc the direct 
neater (D), the data bank lepsto' (6), and the program bank r^sta* (K). For 
more information on these registers, wbich are active only when the 
micropiocessoropei1^ih658i6ttade,se^ (^en-Apple. 

Xfecute). R(esume), S(tep), and T(race}. On the lIgs, the Q(o) 
command can only be used to execute a routine in bank $00. If the routine 
you want to start lies elsewhere, use Uie X{ecute) command. This command 
expects tile routine to end witii an RTL (return liiom subroutine, long), 
however. Like X(ecute), R(esume) will also start up code in any bank. However, 
it JMLs (jumps long) raOier than JSLing (jump to subroutine, tong). Use it to 
continue prograra#gMjlon after a BRft Q(o) and X(ecute) don't wevk well 
after a BRK— tt^HKSSi^ the stack udth their own JSR/JSL ■ 

iilep) mdl^i^aif n Mortteormitn 
Ihe 3,6 DC Monitot OlooMs were left in tte far hnplcnBaflng tot 



commands^llEf print "Step" and '"Hace" on parsed at the moment) 
S(tBp) lets you execute machine language pmgiams ^ instruction at a 
ffine. As each instruction is executed, it and the odhtetits df the registers are 
displayed on the screen. 2000S, for example, would fjegin stepping through 
a program living at byte $2000. To execute the next instruction, simply press 
Sand return. 

T(race) is similar to S(tep ) except that it doesn't stop after each instrucbon. 
To exit T(race} on the 3,5 lie, press solid-apple. To slow it down to one step 
per second, press and hdd down on open-apple. ri^th|:r 5(tep) nor T(race) 
wDrits with po^p^xgs fctuse the sanK z@n9p£^]6Gtiii(Nss;as#eHQtdtor 
itselt . 

MwellaiieoliB lii»idtw coitiniaBcb. Theie are a large number of 
miscellaneous Monitor commands that I should zip through for you. Some 
of them, such as I(nverse ) , ri(ormal), val+val, and val-val, have been around 
since the original Apple II and are still available on the Ilgs. Others, such as 
W(rite) to and R(ead) from cassette tape, have mercitiilly disappeared on 
newer machines. 

In the same class with nnveise) and Nformal) is the control-Y user 
command The conbol-Y command and (he use of II as a command 
^i^jaxatpr Onucb as the 

in #ie Mxm</ and iiB5 Open A^es. Until the ilgs, Oie and - 

Monitor commands were of little value because only one-byte answeis were 
displayed The Ilgs, on the other hand, can take four-byte opeiands and 
display four-byte answers. The Ilgs also has a multiply instruction (val\al) 
that displays eight-byte answers, As before, all of these work with hexadecimal 
numbers only (where 8+8=10). 

While the DOSconimands iri# and FR# are the conectwayto turn oninput 
(tevices atid ptfr^i et&ti Sm lie MotiftciK thfe Wrn^ 
commands Gontroj-K(qrboard) and a}ntrol-P(rinter) have bemiet^ned^lFte 
some reason, Basic^fstem commands don't work as well fittn m^de the 
Ilgs Monitor as Uiey do on earlier Monitors.) Likewise, 3D0Q (or Q(uit) on the 
Ilgs) usually works better for returning to Applesoft than contiol-C or control- 
B, but those commands have been retained as u'eli. 

The rest of the miscellaneous commands are new to the Ilgs. There are two 
commands for converting numiiers from hex to decimal and back again. To 
convert to dedmal, enter the hex number fojlowedby a ^ual siga To convert 
to hf9^ enter aneqMj^titownllsyab^^^^ 

»fF= 

DECl«aI-> 2SS {+255] 
»=ZSS 

Hex -> mmWF 

Control-T changes the currentscreen display to text pagel ifyou somehow 
aash Into the Monitor while viewing a graphics page. Conhol- ( con hDl-shift- 
6) allows you to change the cursor character.- Whatever character you enter 
after conbDl-' wall beoome a fiashii^ curso£ 1ty it also works in 
Applesoft on the Ilgs, 

^^airgsMonftor command Qtatwas mentioned in last month's letters 
s^flqSkltiMs the ament time on your sae<m^ 
=!T=iiiWdi alkivs you to reset th^^ 
panel instead. 

Finally, the Ilgs has a "tod focator" command. This command can be used 
to enter toolbox calls. It begins with a backslash, followed bj/ a number that 
indicates how may bytes worth of input are needed by the tool, follcfwed by a 
number Uiat indicates how may bytes of output the tool will return, followed 
by the inputliytes, followed by Uie two-byte tool number, another tacksiash, 
andaU. 

He^dp^^miyAesoltlj^iy cQmipu]d|ti9tqil|lbeR«Kn'tmetiraand 
Read^Cilibne tools ^cussed ie^ msiith Id k»k in the todbceC' 
pages 3.2H2.k 

•\e B D 3\u I no iriputs, B bytBB of nui^, Bmi feiiaai 

Tool error -> 

eo M IS £17 K «9 M »4 

*\4 e e e 20 e r 3\l) 2We.2i^ (4 in, mna out, seewzeN, toDi seras) 

Tool Brrar-> BM« 

mfimim ^ bi bs bb b? w bi m sfi bb sa eh bi^ 4tts^tli^ ifl*a3:2 
ee/20ie;Re oe cd ee e« m w m ee m ne-E pn 

This call alwasys returns a "tool error, " however, if the error number is zero, 
no enor occurred. 

Thal^thefinalversein Qe newllgs M(mi(oi: Ifs becoming averylongsot^ 
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Ask 

(orteU) 

Uncle 
DOS 



mmliary 64/f bank. If both were asjtive a! (he same 
fime each would ouenvrile the other and chaos 
would refgn. 

However, manij other BAMisks, such asj theoia 
that came with your awatat IWf cari ^^mr don't 
use iiig 64K iGxtQKfed mcmwj/ area or can be 
teti^^mSnotttt ttse E Snoe these fWfiSsftsxlont 
[nteifere with XSaK: pnogmms, then b no r^son 
128ff so^are shoiM diacontKCt them. Tisch note 
*8 has spetifxed since /ate mhat HAndisk 
developers and what 126/( program deuefopers 
need to do to auofdiKOtlBSdlsQowiecSon o/^3 
fwmks. 



t^adits and gentlemen, start your pencils. Onpage 
5.22 nflast month's newstetter, in the nuddle cotumn 
the "AD'afferthe "00/03£W:"sftouldt)e an '.^2." 

In regard to fast month's ietter M chips not off 
sme biock'seoeralsiiJjsciibers Ime wiUUn in Pal 
Qss merno/y canb requiie a type of 256ff RVf cM^ 
caBetf CIS before IMS. litwever, apparentli/ not aU 
ligs caids re^i&e ^ Hnd o^chip. // j/ou need chips 
for a Ugs, I suggest you cai( or wrlle Microprocessors 
Unlimited (24000 5 Peoria Ave, Beggs, OK 74421 
918-267-4961). They sell bulk RAM chips at good 
prices proDide ^t service, send you excelterrt c^p 
(nstallation frisinjctions, and are keeptng 6acls of 
what d^wmk biuMAU^ card& 

fit my mstmr to fist mintft's letter "Odcf flanit 
oiit" / asledf jbr ftet) on c^UiQ the irgs memoiff 
manager tot0t 1ft6 Mnl-Assembter Tue gotten some 
good he/p on that one—youV read all about it next 
month. One of the people who responded was Bill 
Basham o/'D&erM-OOS/ame. tiasham has already 
developed three programs for the Ugs thai are the 
most exdUbng packages I've seen to dat& Hot 
because of stimnb^^aphlQ or soumt mind iiw, 
bud beisme of the ui^ UHty use the memorit 
manager. DberafCache ($35) speeds upAppHe 3.5 
drtoes fnof DmDfafcs) by storing the trades most 
recently accessed in RAM. oiversi Key ($45) is a 
memon^-resident keyboard macro program that 
hides itself iaside the Ugs and prouides macros for 
all your programs, you ftaoe to see this one to 
bdSeve It. llhasU^of ba^ miii whistles, too. Mh 
e^m<^9ieal)oiK^9^fms^$iimsUDii)mir 
BmM,8>ewondetfvimaeik!icixKeaaoiumai6oae^ 
jh this month's lead ar&:ie that iets j|ou get into the 
t^r^/rom the midst of anj/where.Ttesepn9graRa 
Luork only on the llgs, of course, and require 512K. 
(Dioeisiflexl Software Research, 54330 bunker niO, 

Slot 3 RAMdisk rules 

Vl/hy does Apple MMter 2.0 disconnect RAMdisks in 
slot 5? Can this be changed? My RAMWbrks caid 
would be useAil as a RAPIdbli If ^iipie HHtertoald 
stop disoonnectfng it 

Jenyllill 
rro Seattle. Wash. 

n)uiE^a»ffi(&ieme|(Mterestlrtgguestion.4ppte's 
"i>o0QS fxMsi /Ybte #8" esiecpes m o&ffi 
protocol Sat pntfams are s^posetf to im to 
detetnitne lOiem&iiBskdei^ 6i slotSisheitldtie 

dtsconnectedornot This information Is also kduded 
in the Addison-WeMey edition of the FroOOS Ibch- 
nicalRefeiERce Manual I'pagcs 

Frograms that use both 64ti banks of memory, 
such as ilppte HHter 2.0, haoe to disconnect the 
ProDOS slot 3 ifAMdisk became ft also uses the 




At the banning, Afple's own softu^ fqUcmd 
iffw IINA Mote ^ pRimsl^^ 
it 6106% But then something happened. Ken tish 
nrnKK loho recentty sent me a ton of in/brmaHJiDnon 
(his issue ^much of which I'm using here), thinks that 
the key event was Apple reieasing its own memory 
card. In order to keep Apple software from uiorking 
with third-party memory cards, Apple stopped fol- 
lowing its oujn Tech JYote, fiashmareic surmises. 

Accordb^ to the ibch Jtote #8 protocol J2m 



on(if those deutcestfot are connected to sIot3, dt« 

2 and that haoe the law ttvo bits of their device 
number set This translates into units with device 
numbers of $BF, $55, $B7, and $B3. The key instruc- 
tions that accomplish th'ts feat toad the device list 
entries one-by-one. AliD each with «$F5, CMP each 
to«$B3,mibms3ib>d^xmBatkxAoesav^<m 
up "e<juat' " 

tlouieuer Apple WrUer 2.0 and bter, Af^elfbrks 
15 and later, and Instant Pascal haoe two btfies of 
this protocol changed. All of these products AND 
with H7Q and CMP with ^$50. This has the effect of 
disconnecting any slat 5 disk device, uihether 
assigned as driue i or drii;e 2, whether RAMdisK, 
ftarddi^ or^fil^'s own disk. 

There are two wa^s to /ictheprab'em. Ont is to 
search through programs that disocmneet iki 3 
/MWdisfcs looking for the byte string B9 32 BP 29 70 
C9 50. Change the 70 back to P3 and the 30 back to 
B3. This will make the program follow Apple's 
published protocol and your RVfdisfc witl no longer 
be disconnected. 

Aitottierway to avoid theprotiiem is to not assign 
^iS^e0to^S.l^A0(eiEn^neerliigatvi 
Chedcmate3teAin#gif iteve 
so/tuiare so Bat Balf Wl^slks tan ^ppar to be In 

81012. 

So, u;h i« do Appte IMriter./lpptelK)rte andAutBirf 
Pascal disconnect third-party fWldisks m slot 3? 
Does a Fortune 500 company with $800 million in 
the bank really disregard its own software protocols 
just to fliue its RAM card a competitwe edge over 
thorn ftom thlrd'partf; deixlofiens? J personatlj/ 
teSetK the ^noerii^ of >SciiHe^n)cain,OTdaa$^ 
when thejf s% that theif mrifze the impoitmx c^f 
thlfd-partj^ deiwfopers to Apple's success. However, 
they can 't be expected to go over every byte of code 
in Apple software. And it doesn't take much imagina- 
tion to picture some lou; ieucl product manager 
being more concerned about achieving .sa/es goats 
than atiout Scullegs third-party pMosoph^f. 



j'lppJe's officers need to let the public and tts 
employees know, by actions not words, where they 
stand. Why doesn't Apple's software follow Apple's 
awn protooots? lots of people would lite to fcnoui 

¥mi ivanitaseea^fnlax error? 

Is tiiete any softwaceOiat translates udiat you wMe 
in American Ensjl!^ to FfericanSpanIsli?If»,piei^ 
let me Kno«( Titeecl to constan^ir get menioa, 
translated 

Donftobinson 
Cofonado.CA 

Dennis replies TTte question you ask geetna rra- 
sonatiie; translation seems to tw no more dlflflcuft 
than loofcing i^p words in a dictionary and arranging 
them tntoa sentence in the new language. In truth, it 
Is a lot more complex than thai; there are verti forms, 
context and syntax ^among other things^ to consider 
in mafclng the translatlDn, In fact. Just tiansiatir^ 
llligIA MbatKntimnS^ oonipiisr can iimfeistand 
is dignadtemwgh, to sa|f no(A^ o/tfiengtft&% the 
Computo- to express wtat It understood In :^pan{slL 

In order to communicate with oon^uters noiuadlj^ 
we humans hai« to leant lar^uages such as j4ppfeso/l 
or l^cai, which haue very limited vocabularies and 
very rigid sets of usage rules. !n a word, our answer 
to i^our question is "no," at least for now, but the 
issue as to uihether such a prpgiam wlU euer be 
aniaiMelslMeiesaiig. 

T)anslating human language ^ into a leatm of 
computer research caOed art^tcial inte^ence, or 
"A!." Several excellent books haiv been written that 
debate whether computers, will ever be able to 
handle such complicated taste. One that argues 
against the ability of a computer to simulaie human 
re^nses is CoinputerFouier and Hunan Reasoa 
iilf Jbseph IMBizeniHumM'J. Aeemanf, Hidzentj^ 
is a ptimertitMnaeia^mlwmoi^jba^ 
computer game ESia, which proultia jiqcMitttst- 
iike responses to statements erdeitd by a huirian at 
the keyboard. 

Mother boc^ which argues ag^nst Welzenbaum's 
dismissalofthe practiadity of A! research is Qddel, 
fischer. Bach by Douglas tto/stadter (Village Books). 
Hc^^ter leads us thn»^ a dpcuit iuit enlfgftten^ 
process of atten^tp^ (0 pnxK tfat a con^ufer is 
capai>le of at least ^ulatbtg human Int^tsence. 
ilr^ne seriousli^ interested in natuial languas^ 
processing or other topics may want to seek out 
these books, as well as Attificial IntdHgaux, by 
Patrick tienry iVinston (Addison-Hfesley^, and follow 
their bifi/iographies to further referenr£S. 

The computer language of the Al community is 
called IMP. A^AJ version of LISP requires a lot of 
oi^^»^power.LBP.byFtiiUMtknr]i¥^^ 
Beriftoidfflaus Fatilkm (MBaon^aflt^). brnms 
readaMe text about the sut^ct Lego, whtcft at teast 
some of ourreaders (and more ofthelrcMdren} are 
familiar with was derived from LISP. 

natural language transtation is similar in some 
ways (0 the command inle/pretation done by adven- 
ture games such as lark. Zoik's interpreter was 
' drlgln^ implemented on a Digital Equipment Corp 
nORiooinputer using a lJSP4lk» language cajled 

micros for the commercial oersbms of the game. Pot 
some insight into the design of the ihte/prcter, see 
"haul to Fit a Large Program Into a Small J^achine," 
CreaSve CompiOing, July 1980, pages 80-87. for 
additional articles on the design of adimlure games 
that seem to interact with tii^ human plgq/ers, see 
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Oeoemter 1990 Issue c^Qyie; 

Beadera toho are Mevsted bt this kM of stuff 
mjgftl fBee to (neestigate Foia ware's aduenfure- 
game Interpreter /or t/ie /Ippie //, ivhkh is <aaed 
CoH^rehend. The cost is $95 from Potaiwam, Box 
5U Qeneva. tL 60134 d00-323Om. 

CALL -875 

I have a program that was written isr my dd n-Hus 
and it worked fine— now I have a new Ugs and the 
papogram sends me strange machine language screen 
entries. The program includes both a CALL -875 and a 
CALL -868 and guess Is that one or the other is 
causing this. Is this awBd? If SO, arc aiy «»f Hie old 
callsstill valid? .• Bob Schmidt 

District Heights, Md 

C4LL -875 fciear cunen^ screen Me) has nottn^ 
valid since tiie jiU?wfjucUon □/ 0ie Js. Ihoseef^ 
sldpplng from a ff-fhffi to a ff^s nia{f fmestim 

catching up fo do. CALL S75 on the //-Rus .^0^ 
into the middle of the screen scroll functlorts to dear 
the OiTTent fine. Apple changed these routines wher\ 
rewriting the moni£orfiOi'*r/orthe lie. On theJ/gs, the 
code thai replaces these routines generates Ok 
strata messe^ j^u've beensedtiig, 

Oe enflie ttne fa^^ from ^Oeai^ uttfiout 

la 01 - PEOCiaS): poke 36,8: CALL -m-. POKE 36. CH 

Mh the BOcotimn firmware or, on the other 
iiam]; ti>te oomcf uiew to dear the cnrient lite fs to 
^M m^i iOi^^M to Che screen ^controI-L 
CtEK^H), iM dm ite lOibte screen; control-K 
OlB$(ll}, will dear from the cursor to the end of the 
screer\: and contml-j, CHR$(29), will dear from the 
cursor to the end of the current line). That technique 
is better, for compatibiliiy reasons^ than calltng a 
Monitor routine. Too badtt^oisntumkv^ttieStO- 
a^wmfimamecff. 

/ifpSe has pHbsShnf senerar fsi^h% dpm^ 
JJsis of Monitor addresses that it promises not to 
change on /uture/lppie models. /Iny G4LLnotonone 
of these iists should be removed from your programs. 
The wersion of the list that's my current personal 
favorite is in the jlppfe lie T^hnical Kefereiux 
Manual (3.5 ROn msion) on pages 513-314. 

The great Tinaja Quest 

' ¥Btodri«hati8 -nnm questintf 7 j^,^ ^ bishop 

Kfngs&nirOid. 

Don Ijincaster often offers a "tina/a guesf for two, 
t:0.li. Thatcher, Arizona" as the grand prize in the 
contests he devises for his "Ask the Quru" cc^umn in 
Cm^fWter Shopper ($21/yr, 407 S HiUshinston, 
TmBm,FL32796305-26&-3211}J^mif5figfma 
fttiiBSSoinetftfttgatea st^Mgi bvtDouibaaea 

and astod. Lsmmkrsaliid he um &m plaast to get 
people to csn Up aid ask quesUdni. 

Then he said that "tin^a" is a name for natural 
ba.stns found in deserts in the Southwest U.S. (usually 
these basins are private and remote; their name 
comes from the Spanish word for a large earthen 
oeasel). Uke an oasis, a tin^a may be the only 
source water and r&^ in & desert, so '^tn^fa 

fjtoasant recreaflbnalpuisitK: 



■hitehe/^£i3Rcasteron (he fine, Dennis asted if 
ttenB loas 10^ to^ (he y^Hife Mjter "b»d /Be 
fo scieen" ftmUon so that It ahj;aj^s used the 

bacfcsla.sh rather than the current uttdeifine character 
(see aovembe.r 1986, page 2. 77c and February 1987, 
page 5.2). Uncasler said the complde details were 
in his Apple Writer Cookbook and his May 1987 
Computer Shopper column (page 244), but the 
essential details were-bload AWD.SYS at $2000 
and then, for [«rsion 2.0, 596E:C9 5C EA; for version 
2X J974:C9 5CEA.Ajid Ifyoud like to mafce^fyple 
Miter prtnt Vtrough a llgs serial portr mate these 
patches at the same time —for version 2.0, 4DBQ:60, 
4F67:10, 4F6E:15;forver}iion2J, 4DC7:60, 4nE:10, 
4rS5:13 (from Lancaster's March 1987 Computer 
Shctppercolumapage 108). For the complete houi 
lOiy, and ujAere/ore (^thesepatchesi, gftieL^uaster 
a^ingie. 

APDA erratic on way Up 

Immediately after readng your Sei^ember W86 
issue I aeid: 120 Id the l^iflit hogimmscs and 
DevelopBa timdMtm and asked to tKcnme a 
member. Iti Detsmber I tsdled their oOice and as a 

result received a receipt for my i20 and a promise 
that I would soon receive a membership agreement 
form, in January ( called their office and as a result 
received three membership forms. 1 promptly signed 
one and sent it right back. It Is noHrffatdt aid I still 
don't !U am a metnbet en not 

Joining APM seefflS sAoQt m dSSoM as gettlBg 
technical information out of Apple, Am I doing 
something wnang? Is anyone else experiencing this 
mat Idnd of dJiftcul^? Ch uck Zamzow 

Battle Creek. Mich. 

APDA is alive and mil and caicfting with ilsdf 
You re not the only one who has had a d^fiadt time 
joining, but AfD,^ assures us you're a member.APDA 
greir from no members al aii in /August to 7,000 by 
the first of the year to llOOO currentiy (and stBi 
grouil^. It took awhile forAFDA to gear up to the 
(femSKl, 4 laigs iiaddctg deveioped in December 
and JSmtailrtecause of members .signing up at the 
end of 1986 to take adtantage of a free book offer. 
The backlog ujas finally cleaned up in February as 
staff was added. Shipments haue been up to speed 
since ifien, according to ourcoileaguesatAFDA 

Programs, programmers wanted 

Softdisk is constantly looking for short Apple II 
programs of all kinds for publication. In addition, we 
expect an opening around May 1 for a programmer- 
witer^^th extensive Apple technical badcg^uRd and 
capab% of learning and lB»fC. 

. Magazines on Disk 
4023 Qieenwood Road 

Mtgetseueraf requests a year for information on 
BteT^Stwey" for programmers to gettheir software 
pubAshed. TTicre are many mays, which range ^om 
starting your own software publishing company to 
donati'ngyour liwrfe to your ioca! usergroup'spuliflc 
domain iibrary. In between area numbw o/ outlets 
that are often oiierioakcd, such as Softdlak. l^tbae 
(80x299. tiewpoit liI1)2840), theimeOuiJoaml 
^5734 tamar, J<fEsslon, KS 66202). and m Appte It 
marlines th^pHi^fgt^m Mngs. 

l%Ht people don't reaittze that the msgor cost 
tnwAwd u;j&i piibffijhlrtg so|^re Is maricetfng. 



Salespeople, advertising, and d^ater dlSocaa^ m 
inaedib^f expend If you decide to start yourcnm 
company you'd better either haue deep pocfc^ or 
an inaqKnstDe marketfr^ scheme. 

One such scheme, which has been oery success/iil 
ii;itha/eiiiso/tijjarepaci(agfi.s. Is 'sfiareU'are."L'nder 
this system, you encourage users to make ccpies of 
your disk and to distribute them to their /Hends. 
ftwKver, btf means of a screoi that appears when 
thieprQgp«m is starte(t i^u asltiwople 
use {pw jHOduct to send a p^ipnait /or the 
frogram The /Iistproductlofreaicxxss^ distrib- 
uted (hfs uay in the Apple II world wasBUlBasham's 
DbadDOS.Basham recently toidusthaf at>out25 
per cent 0/ his Diotae^H&S bmme oonws frm 
shareware sales. 

Jfecently a number of shareware auShors jcmed 
togdiier In a 'i)rQgfBmmirig cooperafiue" to get 
morelnar^/romtheirmarltetinge^Qrts. TT^ipstpls 
rsiledUtiinQbesiiithSollmxiMSF^^ 

sanDieffo, Ot^mmfm-srh). 

Another route Is to sell yourso/tuiare to an estab- 
lished software publishing house and colled royaJtiRs 
on sales Or maylx you'd tike to do contract pru- 
gramming/oranestabitsfifd finicse— Jiogcr H&gner 
Publishing (P.O. BOK 582 .Sanfce CA 92071), for 
example, is eoen roi« looldr^ for some help from 
peo^iriwouinafllgsandjiErKwassem^lar^iiage. 

Pascal RAMdisk loader II 

I n^ittHi Uaesl^flKMtar ^&xmsW0. page 
3.5) from KeltllEiertsb^i^SiiaglllKH 
for Apple Fasceit 13. HeneTa as jft^itattve method to 
load startup ffliK onto flie RAH disk ton a 35 inch 
disk. 

First, format your RAMdisk using ro^UOTTER 
version 13 (the Pascal formatter hi Hk FIdDOS 
System Utilities will notwork}and transfer aUttiB Dies 
you want Into the RAH disk mamiaOf 

Theii use the t}Tansfer cotiiniaitd saying 
fWIS:JfVDISKf ASCAUBAOe The filer will irapond 
wHft "Ttanster xyz blocks? " Press "N" and spec%ttiE 
number of bloc ks that your data occupies on the dish; 
this is found at the bottom of a catalog listing. If you 
select the default Size instead, tlie full volume, which 
is mostly empty space, will be transfened. That's 
rather wasteful. 

To use tbis Ale, l)oot up Pascd as usual. tlKti 

respond with "Kemove all dies k>m RAN5:7" After 
pressing ' Y' the RANdtsk will be loaded. You can then 
press control-reset to boot up from the RAMdisk. Of 
cour.se, all this can be done from an Exec program 
such as the one Bernstein wrote about in his letter 

Incidentally, you may be shocked to leam thattaeic 
In Australia the llgs retails for aroimdlA3d90and^ 
llereliDfitiarabQutSAim 

DaiyiChestmee 
Bdltin9le,\fc 

iJennbtriedtMsaridsilps ttghiiBs^iseaf (l»sSHn^ 
systematic RVfdEA starS#^itfdkitvn pnxedares 

we dextibed for other pperatir^sj^ems in December 
1986 ("KAi'! van Unes," page 2.B7). To consewe 
space, Dennis suggests the RAMdisk should be 
Crunched with the Filer before determinirjg it's 
biock size and saving out it's contents. And, as you 
point out, this techn^ wipes out ar^ pies already 
onrnMi^mhrnilfe^ixi^b 

Theprkesy0U{fuatemalmt$285^ 
U.S. dr^isrs. If yotff tmpait taxes on goodis from 
Sngapcae (where-fhe %s is manuj^actund^ aren't 
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wm/ij^than those MieU&. the differmx must 
hafdSgfiL ISeriDus^f. ^Rplete doing a magre^axnt 
job~fora US. company— bi deueloplqg products 
for a unrtd-uiide market. Are you sure at least part of 
the dtffermce isn'tAustrallan taxes? There s to other 
tegitfmate reason/or thatlaige a price difference — it 
jukeitoomgea Macfc mtkettama^m) 

Stop double RAM load 

Alan Bird's "Don't pass go " prograrn br AppleWorks BDtlk aild tt^ 9^"^ 

(riovember 1986, page 2.75 and December 1S86, 



SI POKE :«GB.44 I REH no sp«c« b«P 

et POKE 14148.208 

El POX 14149,19 s RDt no ratum for data 

7t fm flOfeiaZ?! TO UB73 

?1 5 POKE Mlft,234 

72 NEXT : REH no Bfflldick preload 



pacje 2.84) has been most helpful, but I have run into 
a bit of a snag with AppleMtorks 2.0, This version 
automatical]}' loads itselfinto RAN atslarti$,^iDce I 
iwialiy aheacty have the program on my RANdisk, 
tbenejitiio reason to bad It again. Do you know how to 
keep h bm dolug tbat wlttiout baring to pitss Ihe 

Harlan R Davis 
BoliiigbiDOk,UL 

Hums 

1» REM *»» Dan't Pass Eo Far RMIiilah «<» 

n lEXT ! Hiiie ; vfTflB « 

2S 0l-CHI»(4) : FI=-flPLHnRKS.SV3TEM" 
» PRINT tlI;-BLDflO':FI;-.fll2eee.T3Y5" 

4e ir PE£x(a2S0) < > s? then pbint 

"Program rEquires flppleUorkB 2.*.' i EMD 
45 PRINT 'Patching flppleWorks" 
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M04t rtgtils tesenei. All programs published In OjMiivlpple are 
puUlc iomm and may betopletf tnd dittrlbulad with ouUtiarge. 
Apph UMf groups and signrani olhera may nprinl artielas from 
lini« 10 lima 1^ trifle written rtqueit. Requaais and oihei 
adltpritl nutaf^.tnctuding lettera ts Uncle DOS, should be aeni to: 



P.O. BOK 7651 
OMriawl Ml, Kansas 86207 UMX 

..Jmonthlv since Ja^i;£-y i^flE WoHd *<d3pnce3 {in US, 

;altmalldelii«ryiiic!udE:a: ■■ jad: :i.^r'aicfi3igs;.S2<tof ! 

^»ar $iW for ? )rears; tGO for S years, Wl single Dac^ issues are 
(Ufrenrly ai.Jii'*'i> S' ?ach; bound, i odoied tdiUoi^sol Volumel 
and Volurne ? ji - S I : each. Volumes end with the January Issue; 
an fndsfc tor itie pno^ volume is included with the Febfuary issue. 
Plaaie send all aubscrip; ic^ 'e-aed corraapDhdanoa Ip: 

Open-Apple 
P.O. Box 6331 
%acuse,N.Y. 13217 U.&A. 

Subscribers in Ausiralia and New Zealand should send 
subscription cori^spondefKe ic Open-Appte cfo Cybernetic 

Ri!5ear<+ L13. 5'6Mal«n '(Md.Pial^'an VtC3181,*lBTfl*UA. 

Opvn-Appie is s /a 'able Dr dif^k lio*^ Speech Enlafprisaft, P.O. 
Bij* .'.I6C H,^siori Te^as~"2"Qi7'3-4fiT.|a66l 

■ Ir m ."o---e'c a' s5-tw,ue Opcn-Appte is sold In an 
L-i[j-_[^., vj jr' ar 'jf your canwRriif^nctt Yuli are encouraged to 
Iraki; bi.-- ..p a'chival copies or aasy-lD-read enlarged copieslor 
your o«r u so wiilioiK charM. ,»hi RMy tiM CCM lta«M|rplelgr 
di sinbu lian to cithers. The dislributittn tea la ISeensper pagaper 
copy distributed 

WARRANTV AND LIMITATION OF UABIUTV. I warrant that most a) 
Ihe Infofmaiicr, m OpewAppIe is usetui and correct, allhougti 
drinel arid misia-iep are 'c jded Irom time to time, usually 
ur tl^it Dnai V .Jrs^ii sli=: suo^cnbers may reiurrt i?:5uEs *r!r i 
'^C -a^'^nfdsl , : i a'.jll -e'jrd Please include a note tro-~ yj^- 
parents 01 ch.ld'er corirmirQ f^ai all ar^itttval copies ttsvetieen 
deslroyed. The untu :',"ie[: pi^rlio" o; ary pa^d sj^seription vitfbe 
rehinded on request MY llAaiLiTr FOR ERflORS AND OMISSIONS 
IS IIM'TT) "0 THIS PUBUCATIQW'S PLIflCMASE PRICE. In no 
< i-e n.^i; I '^r my contrlbulore be MHs Ibr any kicidantal or 
i-.:>n.-.cq<:oi-ii.,i.: damages, rw btanydamagei rnaasatl ca (he (eaa 
paid by a subscriber. 
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1 use a C-Vue LCD screen a lot irs like eating tofu — 
you eventually develop a taste for low contrast But 
the "insert" cursor In AppleWorks ithe blinking 
underline) is impossible to find. The "replace" cursor 
never gets lost Most of the time Iiae i nsert mode. Is it 
possible to patcb^pleWorksso that the inseit:mQde 
curawisabHBkingiav^Uock? 

lb rqdace miderlfiie cftaracter uKft a neiti 

ualue. use: 

BLOfO fiPLH0RKS.SVSTEn,H12eW,rSYS 
CflLL -ISi 

<addr>:<val> 
jOOG 

aSMZ HPLNDRKS.BVSTEN.flJZeM.ISVS 

ivhere <add;> is 2D80 for veralon 12, fax 
oaalon 13^ orlMl for t«rston2.Ct and<£^J^ihe 
AStJIoabteyou want fiirymircamifffN'^o^ the 
underilnej. We tested this patch using "IT' for the 
vslue, which gives a /lashing c/ieclcerl)oart/ Ikix for 
the insert cursor, and using "20," which glues an 
inuerse bat llhinkyouU be able to see 20 better, but 
you may haue trouble distinguishing it from the 
replace cursor— the only digfierenoe loiU lie that the 



tot^l$i^o^m0immieiiMmitomm 

AppfeWortB reset 

Please give us a patch for AppJeWbrks that makes 
reset work when AppleWorks hangs, I'm looking for a 
more general sdution than those you mentioned at 
the end ofyour answer to "Insert system disk and..." 
in April (page 318)— something that would nmk 
withoirtJVam)iibrteoiuMi1nf^etc.Tliemiin6l 
be aiifann stntaddiesainAiipleiiMte somei^iael 

Thorn 
Tbronto^Ont 

Sack in June J&^p^e$JS5, wepMattea "Aa 
AppleWorks HmiB ftamrn" em uwto irith aD 
AppleWorks uersionspribrtoZO. A ftas the aduant^ 
of being uaefid after AppleWorks hangs. The other 
techniques we mentioned in June inuolue your 
doing something spcctaffte^revlppJeHfcirfcs hangs 
so that you'll be able to recouer. /fere's an insiant 
repl^ of the June 1986 routfne, alorig with some 
new informatfon on how to mate ft vsork miih 
J^pleWbrksl.O: 

Press i:ontroi-rB8et to get Into Uia nonltor. 
Ill ^ can't gatt ta CHa HOtitor, go to Jail.] 

•C«73:e 

*3 control- P return 

[If this doesn't got you dS-^r^il-j-.-li. qo to Jall.j 
•2re:2C B3 CB 2C Ml OH -IC 
':33 le <--for f»)pleHarks 1.1 through 1.3 
»:2? 11 <"for flpplBHorks Z.e 

nrts 



If the main nienit appears messed up, just press 
escape. Save any files you have on the desktop and 
lebootaflenufagthis (edudqiK 

More Rial meigeoategoitee 

There is a peculiarity to the mail merge fiinctfon of 
Appleworks 2,0 peoplesbould knowaliout I couldn't 
understand wt^ some of the categories bom my 
database weie not lieiiig lAdted iqp atid Inserted, as 
^xdfied. In juy ibrai leltei; Itisl be^ toWx^ 
about UK fiKt tbat ffie laafl tne^ data must be 
printed to the clipboard a fiibles-style report 
That report format has a default platen wdth of 8 
inches. Sure enough, changirvg the platen width to 
something greater (e.g., 17 inches) allowed all of my 
categories to be printed to the clipboard Changing 
the characters litc^ m 17 can acKompM fte 
samethin^ 

I tope tliat Hiis saK someone a beadadKffl- 

fun 

■ llliraamJ.Unvi]le 

Hsne Haute, Ind. 

Telephone feedback 

i want to thank Jim tfercules for his Inspired 
AppleWorks phone dialer (April 1987, page 318). 
Because of his discovery that you can set up a 
modem as a printer in .AppleWbrks, 1 now have an 
inaedit% fast and easy to use phone dialer. But 
mn^lBt^seadiieetfile. Row 1 Is a name. Row 2 is 
tbat mtHii 0aais umbo, incbidhig 1 and area 
code If iffieded; ibw S b UiB oqeI name, Ifa)w4 tiii 
person's phone number, and so on. I start tie i^Mkie 
number with a " to make it a latiel so T can indude 
commas for pauses and dashes for readability. 1 can 
open-apple-F(ind) the name I want to dial, use the 
down arrow key to highlight the number bekw the 
name, then pnnt ttiat row to the modem. 1 can scroll 
ledt aoA fgcb ttUDa^ my phone list insert delete, 
at make diangea tfocules' suggestion is one of 
Hiose oulstamUngly useM tips that IVe cotne to 
expect from Open-Apple and its readers. 

Thanks also to Tony Bond (page 3.20) for the 
suggestion to copy an AppleWarks L3 SEQ.PR file 
onto an AppleWorks 2.0 disk in order to get control-* 
entered as a printer command. This seems to work 
fine, but if you're using Applied Engineering's Apple- 
VibrkslGxpandetyoull h^toicinstaD ft (ituseste 
SEELPR file for infonnalfon of Its owd). Th^ means 
idnstalling Super ftamilHt»ka,too. 

1 have a su^esUonfor Jim Thomburg's problems 
with using date categories in his AppleMxks genealogy 
data base. AppleWorks' two-digit year just doesn't 
make it in genealogy, but dates can be eHecUvely 
manipulated manually for some very usefiil reports. 
Enter birth dates in three categories: Birth-Year 
OaeO), Bhth-Month (02), and Birlh-Day (29), Do the 
same with death dates. A chnmoki^cal soiX aU 
leoords birth date b cMl^r aoctMiptlSbed 
multiple sorts— sort days fir^ then monttis, |bc:9|t 
years. You can also print reports with calculatad 
categories tliat subtract Birth-Year from Death-Year 
and Biitli-Mon th from Death-Month to give approximate 
age at death. 

Another option is to enter dates in asisglecategoty 
in the following format 1873-07-22. tUsbl|i»tsortS 
flioejly ajphabetica% in foiwanl er Rwese otdec So 
brlVeiNindtiomedftrAplAei^^ 
fBabmsfei my genealogy data base, (teq^ilstis^ 
iKssin o&er situatkms. 

C. L. Roberts 
Lafayette, Calif. 



